React 要重写文档了

（给前端大全加星标，提升前端技能）

作者：魔术师卡颂 公号 / 卡颂

Vue和React，谁才是更好的选择，这个争论似乎从未停过。但在一点上，双方粉丝似乎达成了难得的一致：

Vue文档比React文档好太多。

React开发者对此的解释是：Vue是国人开发的嘛，写出来的文档当然更符合中国人看啦。

但从#3308^[1]来看，似乎全球React开发者都苦文档久矣。以至于在这个issue中，React Core Team成员rachelnabors声泪俱下的说：

“为了弥补官方文档的不足，热心的开发者们自制了很多React教程。我们多么希望从你编写第一个React组件开始，直至你职业生涯的终结，官方文档都是唯一那个陪在你身边的‘他’啊”。

随着Hooks认可度越来越高，可现有文档是围绕ClassComponent展开的，Hooks只是一个独立章节。

基于这些原因，React团队决定重写文档。

React文档难懂的本质原因

文档之间的差异真的仅仅因为“中国人编写的文档更适合中国人看”？显然不是。

要理解文档的差异，需要先谈框架的差异。

Vue基于“模版语言”开发，抽象程度更高。本质上他的文档就是介绍“模版语言”的语法。

那么就把需要的语法背下来就行了。

而React抽象程度更低，直接使用JS（JSX仅仅是语法糖）。

相比于Vue语法靠背就行，React需要花大篇幅讲解各种数据流、设计模式如何在React中使用。

君不见为了解决组件复用，React有HOC、render props、组合模式等众多概念。

这一下就难了。

新文档有哪些改动

知道问题的症结，让我们看看新文档会有哪些改动。

1. 以Hooks的使用贯穿整个文档

不再以ClassComponent举例，这也表明Hooks成为事实上的开发标准已经获得社区的认可。

1. 为编程小白准备的“术语、概念解释”。

React，包括Redux很喜欢（修改下，是非常喜欢）用各种理论、概念指导工作（比如代数效应之于Hooks）。

这让很多前端一边惊叹“高大上”一边哀嚎“看不懂”。

为此，新的文档会增加很多术语、概念的解释。

1. 更多的示例图，在线demo，集成Dev-tools和lint。

图文并茂方便理解，在线demo方便边学边练。双管齐下，用心良苦。

并且，这次新文档由蛋总（Dan Abramov）亲自操刀。前端届顶级网红出马，重视程度可见一斑。

什么时候能看到

这么香，什么时候能看到呢？官方给出的答案是：2021年初。

当前版本文档会归档，新版文档不会在当前版本文档基础上修改。

如果等不及了，社区提供了基于Hooks的当前版本文档^[2]解解馋。

参考资料

[1]

#3308: https://github.com/reactjs/reactjs.org/issues/3308

[2]

基于Hooks的当前版本文档: https://reactwithhooks.netlify.app/

推荐阅读  点击标题可跳转

觉得本文对你有帮助？请分享给更多人

关注「前端大全」加星标，提升前端技能

点赞和在看就是最大的支持❤️